Overview
The WhatsApp Send List node allows you to send interactive list messages via the WhatsApp Business API. It supports two modes for constructing lists: using a JSON array or manual entry. This node is ideal for automating customer interactions, such as sending menus, options, or surveys where recipients can select from a list of choices directly in WhatsApp.
Common scenarios:
- Sending a menu of services or products to customers.
- Collecting feedback or survey responses with predefined options.
- Providing support options (e.g., "Press 1 for Sales, 2 for Support") in an interactive format.
Practical example:
A restaurant could use this node to send a daily specials menu to customers, allowing them to select their preferred dish directly within WhatsApp.
Properties
| Name | Meaning |
|---|---|
| Sender Phone Number (or ID) | The ID of the business account's phone number from which the message will be sent. Options are loaded dynamically from your WhatsApp Business Account. |
| Recipient's Phone Number | Phone number of the recipient. Must include the country code. |
| List Header | The header text displayed at the top of the WhatsApp list message. |
| List Body | The main body text of the WhatsApp list message. |
| List Button | The label for the button that opens the list. |
| Mode | How the list items are provided. Options: Array (from a JSON array), Manual (entered manually). |
| Type | The type of interactive list when in Manual mode. Options: Text (list with title/description), Button (list with buttons). Only shown if Mode is Manual. |
| Interactive List Array | The array of list items (as objects or strings) when Mode is Array. Required if Mode is Array. |
| List Array String Property ID | (Optional) The property name to use as the item ID from each object in the array. If empty, uses the string value. |
| List Array String Property Title | (Optional) The property name to use as the item title from each object in the array. If empty, uses the string value. |
| List Array String Property Description | (Optional) The property name to use as the item description from each object in the array. If empty, uses the string value. |
| Rows (Text) | Manually define rows for Text-type lists. Each row has: ID, Title, Description. Only shown if Type is Text and Mode is Manual. |
| Rows (Button) | Manually define rows for Button-type lists. Each row has: ID, Title. Only shown if Type is Button and Mode is Manual. |
| Enable Auto Translate | Whether to enable automatic translation of the final text. |
| Language Code | The language code (ISO 639-1, e.g., en, es, fr) to translate the final text. Required if auto translate is enabled. |
Output
The node outputs a single field:
{
"whatsappResponse": { /* WhatsApp API response object */ }
}
- whatsappResponse: Contains the raw response from the WhatsApp Business API after attempting to send the interactive list message. The structure depends on the WhatsApp API but typically includes message IDs, status, and any error information.
Dependencies
- External Service: Requires access to the WhatsApp Business API.
- API Credentials: You must configure the
whatsAppApicredential in n8n, which should have permission to send messages via the WhatsApp Business API. - Environment: The node expects the WhatsApp Business Account to be set up and verified, with at least one phone number registered.
Troubleshooting
Common Issues:
- Invalid Phone Number Format: Ensure the recipient's phone number includes the country code and contains only digits (no spaces, dashes, or parentheses).
- Missing or Invalid Credentials: Make sure the
whatsAppApicredential is correctly configured in n8n. - List Item Limit Exceeded: WhatsApp interactive lists support a maximum of 10 items per list. Exceeding this may result in errors.
- Required Fields Missing: All required fields (such as sender, recipient, header, body, and at least one list item) must be filled.
Error Messages & Resolutions:
- "Invalid parameter(s)": Check that all required properties are provided and formatted correctly.
- "Recipient not found" or similar: Verify the recipient's phone number is correct and registered with WhatsApp.
- "Unauthorized" or "Authentication failed": Re-check your WhatsApp API credentials in n8n.